home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 19 / Night Owl (The Best of Shareware)(NOPV 19)(1996).ISO / 007a / ncall107.zip / NETCALL.DOC < prev    next >
Text File  |  1995-11-12  |  14KB  |  317 lines
  1.  
  2.  
  3.           ███   ██ ███████ ███████ ███████ ███████ ██      ██      ██
  4.           ██ █▄ ██ ██▄▄▄▄    ▐█▌   ██      ██▄▄▄██ ██      ██      ██
  5.           ██ ▀█ ██ ██▀▀▀▀    ▐█▌   ██      ██▀▀▀██ ██      ██      ▀▀
  6.           ██   ███ ███████   ▐█▌   ███████ ██   ██ ███████ ███████ ██
  7.  
  8.                               Version 1.07
  9.  
  10.                             12 November 1995
  11.                              CellarSoft LtD.
  12.                         Copyright (C) 1994,1995
  13.  
  14.  
  15. ***************************************************************************
  16. WARNING: When you unzip NetCall!, you should see -AV codes on each line
  17. as the file extracts.  After all files have been extracted, you should
  18. see:
  19.  
  20.   Authentic files Verified!   # MQE905
  21.   CellarSoft Ltd.
  22.  
  23. If you don't see the -AV and this message, the files have been tampered
  24. with. DO NOT use them.    Contact CellarSoft LtD. at the addresses below and
  25. include the origin of the archive you have.
  26.  
  27. Files included in this archive are:
  28.  
  29.     NETCALL.EXE    NetCall!
  30.     NETCALL.DOC    Documentation.
  31.     NETCALL.INI    Initialization / Definition File.
  32.     FILE_ID.DIZ    Suggested file descriptions.
  33.         DISTRIB.UTE     Listing of CellarSoft LtD. Distribution Sites.
  34.     ORDER.FRM    Registration Key order form.
  35.         CELLSOFT.LTD    Product information from CellarSoft LtD.
  36.         WHATS.NEW       Revision History of NetCall! and new features.
  37. ***************************************************************************
  38.  
  39. Introduction:
  40. =============
  41.     NetCall! is a utility for use with WWIV v4.22+ Bulletin Board
  42. Software. NetCall! provides the WWIV SysOp with a simplified method of
  43. conducting necessary callouts from batch files or from under a Fido front
  44. end mailer.
  45.  
  46. Installation:
  47. =============
  48.     NetCall! expects to find itself in the main BBS directory.  It
  49. will move to the main BBS directory to run *IF* the BBS directory is included
  50. in your path statement in AUTOEXEC.BAT. You will be returned to the starting
  51. directory upon exit.  The directory structure for WWIV is read in from
  52. your existing CONFIG.DAT and NetCall! will read NETWORKS.DAT, and all
  53. necessary files from the appropriate network directories.  Please read
  54. the section below on WWIV.INI and all necessary settings prior to first
  55. use.
  56.     NetCall! requires a WWIV BBS be installed on your machine along
  57. with a properly set up and analyzed WWIVstyle network in place to
  58. operate.
  59.         The first time NetCall! is run, it will do basic configuration
  60. for itself.
  61.  
  62. WWIV.INI Initialization File:
  63. =========================================
  64.         NetCall! supports the new WWIV.INI style configuration file.
  65. On first run,  most of these settings are configured.  You should read
  66. NETCALL.INI thoroughly prior to runnung NetCall! for the first time to
  67. insure you understand what each setting does.  Later, you may maually
  68. edit this file to customize NetCall! to your needs.  NetCall! adds
  69. NC_REG_CODE to the end of the file when the registration code is entered.
  70. If you insert the lines somewhere in WWIV.INI, it will cause no problems,
  71. NetCall! scans the entire file for it's definitions, it will just keep things
  72. together. If you do not already use WWIV.INI, rename NETCALL.INI to WWIV.INI and
  73. edit as desired.
  74.     Using this definition file, you have the ability to set options you
  75. may prefer in NetCall!.  Directions for adding these options are contained
  76. in NETCALL.INI.
  77.  
  78. NOTE:  If you use locked com port rates in WWIV, you MUST configure
  79. NetCall! using your MODEM speed if your locked rate exceeds 32767.  This
  80. conflict should disappear when WWIV 4.24 is released.
  81.  
  82. Processing Network Pending Data:
  83. ================================
  84.         NetCall! will detect and process any pending network data prior
  85. to making the requested call.  All received data will be automaticly
  86. processed on all networks after the call is completed.  NetCall! also
  87. has the ability to clean up all pending data between calls when making
  88. calls to multiple nodes or on multiple networks.  See NC_CLEANUP in
  89. NETCALL.INI for more on this feature.
  90.         NetCall! spawns to the NETWORKx.EXE files so will, in turn,
  91. call any pre-processors that appear in the networks EPREPROC.NET.
  92. Network cleanup can be done without making any calls by running NETCALL C.
  93.  
  94.  
  95. Command Line Processing:
  96. ========================
  97.    The command line options and syntax for NetCall! are as follows:
  98.  
  99.          NETCALL <node> <net> [A<attempts>] [qualifiers] [D<debug level>]
  100.  
  101.                 node - The node you wish to call.  Monikers ALL, KW, or
  102.                        OK may be used.
  103.  
  104.                  net - The network number as it is in INIT or ALL for
  105.                        all networks
  106.  
  107.             attempts - The number of attempts to call this system.
  108.                        This parameter defaults to 1 if not included
  109.                        on the commandline. A ! in the third position
  110.                        will call the system until it makes a successful
  111.                        connection.  WARNING!  This option does not have
  112.                        any built in safeguards and will theoreticlly call
  113.                        forever if it doesn't connect.
  114.  
  115.            qualifier - The * qualifier will make the call ONLY if the
  116.                        system is ok to call based on CALLOUT.NET.
  117.                        The # qualifier will force a NC_WAIT_TIME pause
  118.                        between calls.
  119.                        The ! qualifier will force calls until a successful
  120.                        connection is established (Use with Caution!)
  121.                        The N qualifier will supress network cleanup after
  122.                        the call is made.
  123.                        The Wx qualifier is used to force a special wait time
  124.                        between attempts.
  125.          debug level - You may put NetCall! in debug mode from the
  126.                        commandline by adding Dx to the command where x is:
  127.  
  128.                       1 - Files access info
  129.                       2 - Modem info included
  130.                       3 - System Contact Data included
  131.                       9 - FULL DEBUG MODE NetCall! WILL NOT actually make the
  132.                           calls in this mode.  All normally executed steps will
  133.                           be taken and the commandline to call the system will
  134.                           be displayed.
  135.  
  136.    <node> and <net> (or an appropriate moniker) *must* be included on the
  137. commandline for NetCall! to function and must appear in that order.  As
  138. stated above, if <attempts> is not included on the commandline, NetCall!
  139. will default to 1 call.
  140.  
  141.    <qualifiers> are optional and can be used to tailor the use of the program
  142. to your needs.
  143.  
  144.         The monikers ALL (all nodes or all nets), KW (all nodes with k
  145. waiting), and OK (all ok to call nodes) may also be used to make batch
  146. calls more simplified.
  147.  
  148.         NetCall! also has the ability to call a list of systems from a
  149. text file using the commandline NETCALL L <filename>.  The format for
  150. the text file is one system per line in the following format:
  151.  
  152. 10001 0 1
  153.   |   | |__ Number of attempts to make
  154.   |   |
  155.   |   |____ Network number
  156.   |
  157.   |________ Node number to call
  158.  
  159.         At the risk of being repetative, here are a few examples of possible
  160. commandlines are:
  161.  
  162.  NETCALL 6100 0 A10 *   - Call 6100 on your first  network in INIT.
  163.                           NetCall! will attempt to call 5 times *IF*
  164.                           there are no restrtictions in CALLOUT.NET that
  165.                           prohibit calling 6100.
  166.  
  167.  NETCALL 1100 1 A7 #    - Call 1100 on your second network in INIT
  168.                           7 times waiting NC_WAIT_TIME between calls.
  169.  
  170.  NETCALL 9707 2 ! D3    - Call 9707 on your third network in INIT.
  171.                           NetCall! will call 9707 until it make a
  172.                           successful connection using Debug Level 3.
  173.  
  174.  NETCALL 4241 3         - Call 4241 on your fourth network in INIT once.
  175.  
  176.  NETCALL OK 4 3         - Call all ok to call systems ok your fifth
  177.                           network, three attempts.
  178.  
  179.  NETCALL OK ALL         - Call all ok to call systems on all networks.
  180.  
  181.  NETCALL KW 5           - Call all systems that have k waiting on your
  182.                           sixth network.
  183.  
  184.  NETCALL L CALLME.EXT  - Call all systems listed in CALLME.EXT.
  185.  
  186.  NETCALL C              - Cleanup all Networks, make no calls.
  187.  
  188.  
  189. Exiting with Errorlevels:
  190. =========================
  191.         For use in batch files, NetCall! will exit with one of the following
  192. errorlevels:
  193.  
  194.         0 - No errors, No calls made. (NetCall! was run with no
  195.             commandline parameters or with ?, HELP ect.)
  196.  
  197.         1 - External Error. Data files missing. Invalid NetNumber/
  198.             Registration number.
  199.  
  200.         2 - Memory Allocation Error.  NetCall! was unable to allocate
  201.             the memory it needed from your system.  Provide NetCall! more
  202.             memory!
  203.  
  204.         3 - Your system is not connected to the system on the network
  205.             contained on the commandline.  (Either a typo or a dropped
  206.             system)
  207.  
  208.         4 - Keyboard Abort.
  209.  
  210.         5 - All attempts made, no connection established.
  211.  
  212.         6 - Not calling the system.  Not ok to call and the * qualifier
  213.             was used.
  214.  
  215.         7 - No errors, Call completed as requested.
  216.  
  217.         This feature can be disabled by placing NC_ERR_LEV =NO in your
  218. WWIV.INI if NetCall! causes a conflict in error level processing with
  219. FrontDoor or any other front end mailer.
  220.  
  221. Registration:
  222. =============
  223.         Registration disables the shareware pauses and other encouragements
  224. to register.  Each copy of NetCall! has an expiration date on which, the
  225. program will cease to function at all.  You can do one of three things,
  226. you can change the date every time you want to use NetCall!, you can
  227. download a new copy of the shareware version with a later expiration
  228. date when yours quits, or you can avoid all of these by simply
  229. registering NetCall!.  After all, it's only $15!
  230.         Once you have registered, you will receive your key by either
  231. US Mail or net email.  Run NETCALL REGISTER and input your key.  NetCall! will
  232. append the registration data to the INI file.
  233.  
  234.  
  235. Copyright, License, Registration, and Warranty:
  236. ===============================================
  237.         NetCall! and accompanying files and documentation are Copyright (C)
  238. 1994, 1995 CellarSoft LtD.  Under NO CIRCUMSTANCES shall any revised version
  239. of either the executable file or the documentation be released without prior
  240. knowledge and written consent of the author.
  241.     NetCall! is licensed as a Shareware product and is freely
  242. distributable.  The author assumes no responsibility for the misuse of
  243. NetCall! or the consequences of said misuse.  All inquiries about the product
  244. should be directed to CellarSoft LtD.  You are licensed to evaluate NetCall!
  245. for thirty (30) days free of charge.  After thirty days, you must either
  246. register the product or terminate it's use.  Registration diables the
  247. shareware pause and all other encouragements to register.  For further
  248. information on registration, see ORDER.FRM included in the NetCall! archive.
  249.     NetCall! is provided with no warranty, expressed or implied as to the
  250. fitness or suitability of the product for other than it's intended use.
  251. The Licensee accepts all responsibilities and liabilities for the use of the
  252. product.
  253.  
  254.  
  255. Regarding the Author:
  256. =====================
  257.      CellarSoft LtD. is the trade name of the  author.   The author(s),
  258.      by  use  of  this    name, is  by  no  means  attempting to defraud    any
  259.      individual,  corporation,    or agency or political subdivision  of    the
  260.      United  States government or the public at large.    The  author  may be
  261.      at any of the addresses below:
  262.  
  263.       By US Mail at:
  264.              DNK Enterprises
  265.              c/o CellarSoft LtD.
  266.                      4137 Cedar Street, Box 6
  267.              Ft. Wainwright, Alaska 99703
  268.       By Email at:
  269.                   trader@imagi.net   Internet
  270.                   1@10402            WWIVnet
  271.                   1@9707             SOLARnet/TerraNet
  272.                   1@1                FILEnet
  273.                   1:355/22           FidoNet
  274.  
  275.  
  276. The Future of NetCall!
  277. =======================
  278.     NetCall! will be developed to the maximum extent possible.  If you
  279. have a comment or suggestion for the betterment of the program, please send it
  280. in.  All attempts will be made to implement any changes as soon as possible.
  281.         The CellarSoft LtD. Support sub-board is available as SubType FMAIL
  282. hosted at @10402.WWIVnet, @9707.SOLARnet, @1.FILEnet, and @9707.TerraNet for
  283. bug reports and suggestions for the improvement of NetCall!
  284.  
  285.  
  286. Credits and Thanks:
  287. ===================
  288.     If it weren't for these people, NetCall! wouldn't exist.
  289.  
  290.        Wayne Bell  WWIV     Copyright (c) 1988-1994
  291.                        NET35     Copyright (c) 1993-1995
  292.  
  293.            PKWARE  PKZIP     Copyright (c) 1989-1993
  294.                        PKLITE    Copyright (c) 1990
  295.  
  296.               SemWare  Qedit 3.0 Copyright (c) 1993
  297.                Advanced
  298.  
  299.  Joaquim Homrighausen  FrontDoor Copyright (c) 1989-1994
  300.  
  301.   Special thanks to:
  302.                       Morgul, for primary Alpha and Beta Testing.
  303.                       Byte and Spackle, the only dedicated "bug squashers".
  304.                       Frank Reid for that last minute suggestion.
  305.                       Gene Vaz for testing our Tech Support Service.
  306.                                      and
  307.  
  308.                       All those who tested NetCall! and provided
  309.                       invaluable input in an effort to provide a
  310.                       quality product.
  311. Registered Users:
  312. =================
  313.     Thanks to the few and faithful that have supported NetCall! and the
  314. shareware concept.  It's folks like this that make programs like NetCall!
  315. available to computer enthusiasts.
  316.  
  317.